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Preface 


Citrik EdgeSight for KenApp provides the most comprehensive performance-management and 
reporting solution for the Citrix XenApp infrastructure. Administrators have real-time visibility 
to session-level performance and provide visibility into key metrics such as profile load time 
and login script execution. 


Citrix EdgeSight is a complicated tool and a beast of an application in itself. With this in mind, 
we've made an attempt to cover the recipes that a Citrix administrator might come across 
while managing and supporting their XenApp farm on a daily basis. 


This book follows a cookbook style and is packed with simple yet incredibly effective and 
practical recipes covering the basics to the advanced. All recipes contain step-by-step 
instructions with screenshots for practical and easy learning. 


What this book covers 


Installing EdgeSight Server (Intermediate) will describe the prerequisites to install EdgeSight 
and illustrates its installation. 


Installing EdgeSight agents (Simple) will take an in-depth look at the installation of the 
EdgeSight agent and lists the troubleshooting steps that should be performed if the agent 
fails to register with the EdgeSight Server. 


Configuring the server settings (Intermediate) will present the common server settings that 
need to be configured after the installation of the EdgeSight Server. 


Configuring users, groups, and authentication (Intermediate) will focus on other settings that 
we should also configure after the installation of the EdgeSight Server. 


Defining alerts (Advanced) will explore EdgeSight alerts and illustrate how to create alerts and 
define action when the defined alert condition is/are met. 


Managing the real-time dashboard (Intermediate) will assist in setting up the real-time 
dashboard to provide a comprehensive view of the XenApp server health state in real time. 
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Working with EdgeSight reports (Intermediate) will walk through the steps required to work 
with built-in reports and how to subscribe to reports for automatic delivery. 


Monitoring the Citrix license usage (Intermediate) will describe how EdgeSight can be used to 
report Citrix usage in your environment. 


Resolving performance problems (Advanced) will focus on how to use EdgeSight to ensure 
applications are meeting business metrics at all times by monitoring performance from the 
user's perspective. 


Grooming EdgeSight database (Advanced) will take an in-depth look at how to groom the 
EdgeSight database to optimize its performance. 


What you need for this book 


To try out the recipes in this book, you will need to build a Citrix XenApp farm. For the 
EdgeSight database, you can use the same database server that is being used as the data 
store for your XenApp farm. Another infrastructure server that is used in the recipes is the 
messaging server (Microsoft Exchange Server) to send alerts via e-mail. 


Who this book is for 


This is an ideal book for Citrix XenApp professionals who need to keep a close eye on the 
performance of their XenApp servers and generate reports. 


This cookbook explores basic to advanced recipes that cover the most common tasks 
a professional might undertake while administering their EdgeSight Server in their 
day-to-day job. 


Conventions 


In this book, you will find a number of styles of text that distinguish between different kinds of 
information. Here are some examples of these styles and an explanation of their meaning. 


Code words in text, database table names, folder names, filenames, file extensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: "The 
EdgeSight XA6Agent x64 .msi installer file is used to install EdgeSight agent Version 
5.4, while EdgeSight XAAgentx64.msi is used to install EdgeSight agent Version 5.3." 


Any command-line input or output is written as follows: 


Msiexec /i EdgeSightXAé6éAgentx64.msi /1 logfile.log /q SERVER 
NAME=ServerName COMPANY=CompanyName DEPARTMENT=DeptName 
REBOOT=ReallySuppress 


$A RS 
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New terms and important words are shown in bold. Words that you see on the screen, 

in menus or dialog boxes for example, appear in the text like this: "Verify that the default 
departments were created successfully by navigating to Configure | Company Configuration 
| Device Management | Departments." 


| Warnings or important notes appear in a box like this. | 


| Q Tips and tricks appear like this. | 


Reader feedback 


Feedback from our readers is always welcome. Let us know what you think about this 
book—what you liked or may have disliked. Reader feedback is important for us to develop 
titles that you really get the most out of. 


To send us general feedback, simply send an e-mail to feedback@packtpub.com, and 
mention the book title via the subject of your message. 


If there is a topic that you have expertise in and you are interested in either writing or 
contributing to a book, see our author guide on www. packtpub.com/authors. 


Customer support 


Now that you are the proud owner of a Packt book, we have a number of things to help you 
to get the most from your purchase. 


Errata 


Although we have taken every care to ensure the accuracy of our content, mistakes do happen. 
If you find a mistake in one of our books—maybe a mistake in the text or the code—we would be 
grateful if you would report this to us. By doing so, you can save other readers from frustration 
and help us improve subsequent versions of this book. If you find any errata, please report them 
by visiting http: //www.packtpub.com/submit-errata, selecting your book, clicking on 
the errata submission form link, and entering the details of your errata. Once your errata are 
verified, your Submission will be accepted and the errata will be uploaded on our website or 
added to any list of existing errata, under the Errata section of that title. Any existing errata can 
be viewed by selecting your title from http://www. packtpub.com/support. 
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Piracy 


Piracy of copyright material on the Internet is an ongoing problem across all media. At Packt, 
we take the protection of our copyright and licenses very seriously. If you come across any 
illegal copies of our works, in any form, on the Internet, please provide us with the location 
address or website name immediately so that we can pursue a remedy. 


Please contact us at copyright @packtpub.com with a link to the suspected pirated material. 


We appreciate your help in protecting our authors, and our ability to bring you valuable content. 


Questions 


You can contact us at questions@packtpub.com if you are having a problem with any 
aspect of the book, and we will do our best to address it. 
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Welcome to Instant EdgeSight for XenApp. The focus of this book will be on EdgeSight for 
XenApp, which will include EdgeSight Server, EdgeSight Server Console, EdgeSight agents, 
the database server, web server, and Citrix License Server. 





Installing EdgeSight Server (Intermediate) 


We will now perform an installation of Citrix EdgeSight Server 5.4 and also discuss its 
prerequisites. If possible, you should install the server components on separate servers 
but they can all be installed together on a single server. 





Getting ready 


Install the following roles and features using the server manager before proceeding with the 
installation of the EdgeSight Server in Windows Server 2008: 


> Microsoft .NET Framework 3.5 SP1 
> Microsoft Message Queuing (MSMQ); install common components only 
>» IIS 7.0 (also install the following web server roles) 

a Static Content 

a Default Document 

a ASP.NET 


a ISAPI Extensions 
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a ISAPI Filters 


a Windows Authentication 
a Request Filtering 


o The following management tools: 


>» IIS 6 Management Compatibility 
> IIS 6 Metabase Compatibility 
> IIS 6 WMI Compatibility 
>» IIS 6 Scripting 
>» IIS 6 Management Console 
For your database server you can use SQL Server 2008 R2, SQL Server 2008 SP2, or SQL 


Server 2005 SP4. SQL Server 2012 is the supported database server. Citrix has a database 
matrix; you can check the article Citrix Document ID CTX114501 at the following link: 


Hetp?/ / Support.ci trix, com/article/ CTx114501 


How to do it... 


In this recipe we are going to perform the required operations for installing the EdgeSight 
Server: 


1. Insert the Citrix XenApp CD and click on Manually install components. 





CITRIX: XenApp 


O View XenApp Documentation 


T Install XenApp Server 


= Manually install components 


> Applications on Virtual Machines 


© Browse DVD @ Exit 


Open Citrix eDocs online documentation. 





2. Click on Server Components and then click on Application Performance Monitoring. 


S$ 
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On the Welcome screen, click on EdgeSight Server and then click on Next. 
Select Edgesight Server Website and Database; click on Next. 


Click on Warning to read the warning message, ignore the SSL certificates warning 
if not using SSL certificates, and click on OK. 


jie Citrix EdgeSight Installer 5.4 


(os) CIT RIX Ed ge Sig ht™ Prerequisite Check 


The prerequisite check passed with warnings, Click the messages link to wiew information 
about the warning, Please click next to continue the installation, 


BA Prerequisite i WEEE [Ree $ 


| © Minimum Memory Recommendation Passed 
| © Microsoft Wet 3.5 SP1 Runtime Requirement Passed 
| © Operating System Requirement Passed 
| AN TIS Feature Requirement Warning 
| © MISMO Requirement Passed 





Accept the License Agreement checkbox and select Custom as the setup type. 
Enter the name of your database server and click on Test Connect after selecting 
the appropriate authentication method. 


i a i PEO N A oT NAA 
(c) me) CITRIX | Edgesig ht™ Database Server 


SOL Server Selection Install Using 


( Enter the name of a database server (* Windows Authentication 


[EDGESIGHT] $ SOL Server Authentication 
Installer Information o 


Connection successful | 


(71 Choose an existing databası 


MENAPPA0-2)CITRIM_METs 


MENAPPGS- 1 WCITRIX. MET: | 
1L, - Test Connect 
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8. Enter the name of the new database that will be created on the database server. 


iz Citrix EdgeSight Server 5.4 Setup x] 





(m) CİTRIX | Edgesig ht” Database Information 


SOL Seryer Database Selection 





© Install a new EdgeSight Database 


EdgeSight 


( (Choose an EdgeSight Database to upgrade 


ReportServer 
ReportserverTempDb 


Back, | a 





Cancel 





9. Enter the credentials that the web server uses when connecting to the database 
and then click on Validate. After successful validation click on Next. 


iz Citrix EdgeSight Server 5.4 Setup 


(m) CiT RIX | Edgesig ht” Database User Information 


Enter the following NT account information: 


The EdgeSight Server uses the Following information to connect to its database, 


User Name; |packt-pub\ administrator 
Password: | TELLETT) 


Validate | 


Enter domainjusername or computer\username. 


Syntax For User Mame: 


Cancel | 





10. Accept the default sizes for the File Group Size and Log Files Size options and click 
on Next. 


11. Accept the default path or modify it if required, click on Next, and then on Install. 
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12. Verify that Go to the EdgeSight Server website now. is checked and click on Finish. 








iz Citrix EdgeSight Server 5.4 Setup xi 





The Citrix EdgeSight Server 5.4 
Installer Has Completed 


Thank you for installing EdgeSight Server. 
= Additional configuration information is required to 


complete the EdgeSight Server installation, Please 
launch the site to complete the first-run wizard, 


V Go to the EdgeSight Server website now. 


Click the Finish button to exit the Installer, 




















13. Click on Next to continue with the Post Installation Setup Wizard web page to 
configure initial configuration of the EdgeSight Server. 


This wizard can also be completed later by going to 
http://<ServerName>/edgesight / 





14. Enter a name in the company Name field and select the Time Zone and Language 
values you want to use for this company. Then click on Next. 


Citrix EdgeSight Server Post-Installation Setup Wizard 


| Create an Initial Company 


Enter the name that you wish to use forthe company, 


Mame: [PacktPublishing| 


Every company has a time zone associated with it, The time zone is used to ensure that data gets attributed to the correct day, 


Time Zone: [SMT-05:00) Eastern Time (US & Canada] bd 


Every company has a language associated with it. The language will be the default display language for new user accounts, 


Language: [English =f 


[za] nee] 





— 
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15. Create a Superuser account with a valid e-mail address. 


Citrix EdgeSight Server Post-Installation Setup Wizard 


| Create the Superuser Account 


The Superuser has full access to all of the companies in the EdgeSight Server database, Log in with this user to create additional 
users, 


First Name: [Super 
Last Name: [User 
Email/Login: [SuperUser@packt-pub.net 


The password must be at least 5 characters in length. 


Password: Je....... 
Confirm: [occccces| 








16. Enter the FQDN or IP address of your SMTP server to be used to route the e-mails 
generated by the EdgeSight Server. 


Citrix EdgeSight Server Post-Installation Setup Wizard 





| Configure Email Settings 


Periodically, the EdgeSight Server will send email in response to certain events, Please enter the address of an SMTP server that the 
EdgeSight Server can use to send email, 


SMTP Server: [192.168.1.110 


Please enter the email address to which the EdgeSight Server should send email when important events occur on the server and 
select the language in which the emails should be sent, 


Email Address: [Alerts@packt-pub.net 
Language: [English -] 
Please enter the Display Name and Email Address that will appear in the “From:" field of any email sent from the EdgeSight Server, 
Display Name: [EdgeSight Alert 
Email Address; [Edgesight@packt-pub.net 





Next | 





17. Select the type of agents from the drop-down menu for which uploads are supported 
according to your licenses. 
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Citrix EdgeSight Server Post-Installation Setup Wizard 
| Configure Agent Support and Licensing 


The EdgeSight Server can be configured to support the three agent types below, If this server will be used only for License Server 
monitoring, turn all settings off. 


EdgeSight for Xen4pp Support: On- Basic and Advanced Agents Hi 
EdgeSight for XenDesktop Support: Off + 


EdgeSight for Endpoints Support: Off + 


Please enter the name and port of a Citrix License Server to be used for Endpoint Agent licensing. 


License Server Name: 


License Server Port: 





18. Review your choices and click on Finish; this will open the EdgeSight Server login 
web page. 





The EdgeSight Server is managed through a web-based console and can be accessed from 
any desktop with Internet Explorer 7.0 or greater with JavaScript enabled. Other software 
components that are needed on the system from which users access the EdgeSight Server 
web console include: 


> Adobe Flash 
> Adobe Reader 


> Microsoft Excel 


Ji To update the Excel spreadsheets, EdgeSight requires full write permissions; 


E therefore you should use the Microsoft Excel that comes with Microsoft Office 
2003 or 2007 and not Excel Viewer. Also make sure that you confirm to your 
Microsoft Office license agreements. 


As of this date, Microsoft Excel 2010 is not supported. 
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It is nice to know some EdgeSight terminology; refer to the following table: 


Term Description 


Company Primary organizational unit, a single server can support 
multiple companies. 


Department Companies are broken into departments and create a 
hierarchical tree. 


Devices Any system with the EdgeSight agent installed. 
Custom Groups A user-defined collection of devices. 


Users Users who can log in and display reports and perform other 
administrative tasks. 


Superuser Has access to all companies hosted on the server and can 
create other users. 





A single EdgeSight Server can support multiple companies, each company with its own time 
zone, SMTP settings, license server, and Superuser account. 


The Superuser credential information should be stored and saved for future reference. The 
Superuser account cannot be deleted. 


EdgeSight 5.4 also requires a Citrix License Server 11.6 or above. Without configuring the 
Citrix License Server, the EdgeSight agents will not upload data to the EdgeSight Server. To 
monitor your Citrix licensing server, the version of the licensing server should be at least 11.9. 


If you plan to install License Administration Console and EdgeSight Server on the same 
machine then install EdgeSight Server first. 


Only Enterprise and Platinum licenses are supported to be used by EdgeSight 5.4. 


| Q Enterprise licenses monitor only the basic metrics. | 





Installing EdgeSight agents (Simple) 


The EdgeSight agent needs to be installed on each XenApp server that we need to monitor. 
After the agent has been installed, the agent attempts to contact the EdgeSight Server to 
download its configuration. The installation of the agent requires a reboot of the server and 
may take up to 10 minutes before the XenApp server appears in the EdgeSight Console. 


$Y 
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Getting ready 


If you have to use a proxy server, remember that, for the communication to happen between 
the EdgeSight agent and the server, you must configure a proxy to route the EdgeSight traffic 
to the EdgeSight Server. You can do this by reconfiguring the EdgeSight agent network settings 
of the Citrix System Monitoring Agent with these new proxy values. 


The following screenshot shows the EdgeSight agent settings screen where you need to 
provide the proxy settings: 


F Citrix System Monitoring Agent Settings 


Service Control | Mode | EdgeSight Server | Language | 


Address: EdgeSight ipackk-pub, net Port: jen 


T Use SSL encryption 


Proxy Server 

[ Use a proxy server 
Address: E E Port: 
r Proxy is a non-55L tunnel 


E Proxy requires authentication 


User Mame: | 
Password: | 


OK | Cancel | Apply | 





You must also configure antivirus software running on your EdgeSight Server and all XenApp 
servers with EdgeSight agent to exclude specific processes and files. 


Antivirus exclusions 


Ensure that these agent services are not subject to script blocking on both the EdgeSight 
Server and the XenApp server. 


EdgeSight Server XenApp Server 


RSshApp.exe RScorsvc.exe 


RSshSvc.exe 





These files are located in the following folders: 


> The RSshApp.exe and RSshSvc.exe files are located at 
$CommonProgramFiles%\Citrix\System Monitoring, 
Server\RSSH\ 


zy 
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> The RScorsvc.exe file is located at sProgramFiles%\Citrix\System 


Monitoring\Agent\Core\ 


Also exclude the following folders from script blocking: 


EdgeSight Server XenApp Server 


%$ProgramFiles%\Citrix\System $ALLUSERSPROFILE%\Citrix\System 
Monitoring\Server Monitoring\Data 


%ProgramFiles%\Microsoft SQL 
Server VMSSOL Data 


%SystemRoot%\SYSTEM32\Logfiles 





For XenApp servers with Windows Server 2003 the sALLUSERSPROFILE%\Citrix\System 
Monitoring\Data folder can be found at zALLUSERSPROFILE%\Application Data\ 


Citrix\System Monitoring\Data\ 





How to do it... 


1. The EdgeSight agent can be installed during the XenApp installation or after the 
XenApp installation. If you want to install the EdgeSight agent with the installation of 
the XenApp server, during the installation of the XenApp server, when selecting the 
roles to be installed, make sure you select the EdgeSight Agent option: 





fm Citrix XenApp Server Roles 


e 
CITRIX XenApp Server Roles 


Choose role subcomponents 
The roles you selected have additional features you may wish to install. 


|a XenApp 
Default Components (3) 
4 Optional Components 
|” XML Service IIS Integration © 
V EdgeSight Agent © 
|” SmartAuditor Agent © 
|” Single Sign-On Plug-in < 
|” Power and Capacity Management Agent | 
|” Provisioning Services Target Device © 








M E3 
<Back || net> | cancet_| 
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2. The EdgeSight agent can also be installed after the installation of XenApp or on an 
existing XenApp server. The XenApp 6.5 CD image contains two agent installer files, 
as shown in the following screenshot: 




















rn Agent mel xi 
Gi js | Search Agent DI 
File Edit View Tools Help 
Organize ~ Burn to disc z ~ fil @ 
sir Favorites Name +^ Date modified Type Size 
* Files Currently on the Disc (2). lll 
Libraries ie! EdgeSightX464gentx64. msi 5/31/2011 3:48 4M Windows Installer Package 13,531 KB 
js! EdgeSightX44gentx64.msi 4/18/2011 10:05 4M Windows Installer Package 13,558 KB 
WW Computer 
Gia Network 


à 2 items 


The EdgeSightXA6Agentx64.msi installer file is used to install EdgeSight agent 
Version 5.4, while EdgeSight XAAgent x64 .msi is used to install EdgeSight agent 
Version 5.3. 





The installation of the agent is straightforward; the only thing one should keep 
in mind is that the company name should match the name specified during the 
EdgeSight Server setup. 


3. The agent can also be installed via the command-line interface. A typical command 
line to install the agent would be: 


Msiexec /i EdgeSightXA6Agentx64.msi /1 logfile.log /q SERVER 
NAME=ServerName COMPANY=CompanyName DEPARTMENT=DeptName 
REBOOT=ReallySuppress 





The agent runs as a Service and collects the data from a number of sources including 
Windows Management Instrumentation (WMI) and Windows Performance Counters. 


The XenApp agent collects performance data every 15 seconds and periodically consolidates 
this data into five-minute samples. The data uploaded to the EdgeSight Server is consolidated 
into an hourly granularity. By default, this data is uploaded to the EdgeSight Server once a day. 
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There's more... 


If you ever need to modify the agent configuration after installation, you can use the Citrix 
System Monitoring Agent control panel applet on the XenApp server. 


E> All Control Panel Items 

















G- E ~ Control Panel ~ All Control Panel Items + 


Adjust your computer's settings 


Ye Action Center ra E | AutoPlay 
bed O 


itri itori | Credential Manager 
F Tn, mil 
e Default Programs y Device Manager 


E] Display (Gacy) Ease of Access Center 








The EdgeSight agent operates in either the basic mode or the advanced mode. The agents 
in advanced mode collect more detailed metrics. For more details on the differences, refer 
to the Citrix Document ID CTX124427 documentation at http: //support.citrix.com/ 
article/CTX124427. 


XenApp Edition Default Agent Mode Mode Tab Availability 


Platinum Advanced 





Enterprise Basic 


To configure the agent mode when installing the agent using the command line, add the 
FUNCTIONALITY MODE argument. It can have two values Advanced and Basic. 


Configuring the server settings 





(Intermediate) 


Now that the installation and the post-installation wizards have completed successfully, 
we still need to complete a few tasks such as configuring the Reporting Services, creating 
departments, and groups. 
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Getting ready 


Reporting Services is a component of Microsoft SQL Server and is required as part of a Citrix 
EdgeSight installation to provide a robust and flexible reporting environment. Reporting Services 
provides a central location for report storage and management. They can be installed on the 
database server, web server, or a separate server itself. If you do not have Reporting Services 
configured, the EdgeSight installation process will not give any warning; the installation will end 
successfully but no reports will be available on the EdgeSight Console. 


You can open a web browser and point the URL to http: //<ServerName>/ReportServer 
to verify the existence of Reporting Services on a server. This URL could be different if the 
Reporting Services were customized. This is depicted in the following screenshot: 








S localhost/'ReportServer - / - Windows Internet Explorer 


pe 






Æ| http: //localhost/reportserver ba | +>) | XK [S Bing Pe 


yy Favorites  @Blocalhost/ReportServer - | : - “| Œ v Page Safety~ Tools+ @)- 


localhost/ReportServer - / 
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Microsoft SOL Server Reporting Services Version 10.0.5500.0 


g 


[Done a S| Bl el (Cà Local intranet | Protected Mode: Off Wa v |4100% + A 














This web page also displays the version of the Reporting Services we have installed. 


For more information on how to install and configure Reporting Services to be used by 
EdgeSight, refer to the Citrix Article ID CTX111313 documentation at the following link: 


httpe:// support .citrix.com/article/CTx1113132 
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How to do it... 


1. As soon as you log in for the first time on the EdgeSight web console, you will see a 
message on the top such as Reporting Services is not configured or is configured 
incorrectly. In the Report Server URL field, enter the URL of your reporting server 
and the credentials for the Reporting Server. Click on the Save Changes button. 


| Configuration Operations, eae oN eee SSA MASSES TATA EOS eNom 
| 29 Reporting Services is not configured or is configured incorrectly. | 
| Report Server URL: [http://localhost/reportserver | 


The Reporting Services web service URL that EdgeSight Server will connect to 
when communicating with the report server. In the default installation of 
Reporting Services, the report server URL will resemble: 
http://< servername>/ReportServer, If you have customized your installation of 
Reporting Services, the report server URL may be different. 
| 
Report Server Credentials 


| Enter the credentials to be used by EdgeSight Server when connecting to the Reporting Services web service via 

| the Report Server URL setting above. At a minimum, the credentials specified need to be a member of the Content 
| Manager role in the root folder of the report server as well as a member of a system role that is capable of 

| performing the "Manage shared schedules” task, 


| Note: SQL Server 2008 merged the Manage Shared Schedules stand-alone role with the System Administrator 
| Role. This may require an update to your system configuration. 


User: |packt-pub\administrator 


Example: DOMAIN\username or MACHINE\Username 


Password: [oe ......!| 


| Data Source Credentials 


| Enter the credentials to be used by the report server when connecting to the EdgeSight Server database to run a 
| report, At a minimum, the credentials specified need to have “Log on locally” privileges on the report server 
| machine and read access to the EdgeSight Server database, 





If you have created a new user ID to be used by the EdgeSight Server 

- to connect Reporting Services web services, use this ID. You can later 
Q modify the information entered here by navigating to Configure | Server 

Configuration | Reporting Services | Report Server. 
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2. The Reporting Services Configuration Status - Webpage Dialog window pops up. 
Wait a few minutes for the pop-up window to configure the Reporting Services. Once 
the Reporting Services have been configured, click on the Close button. 


A department is a logical grouping of agent devices within a company 
that have the same configurations and alerts applied. We can map one 
or multiple alert rules, alert actions, worker configurations, and agent 


configurations to devices in the department. 


A Reporting Services Configuration Status -- Webpage Dialog 


Reporting Services Configuration 
| EdgeSight Serveris now configuring Reporting Services, This may take afew minutes, 


Status 


1016/2012 9:31:14 PM 


10/16/2012 9:31:19 PM 
10/16/2012 9:31:19 PM 
10/16/2012 9:31:19 PM 
10/16/2012 9:31:19 PM 
10/16/2012 9:31:19 PM 
10/16/2012 9:31:20 PM 
10/16/2012 9:31:20 PM 
10/16/2012 93120 PM 
10/16/2012 9:31:20 PM 
10/16/2012 9:31:20 PM 
10/16/2012 9:31:20 PM 
10/16/2012 93120 PM 
10/16/2012 9:31:20 PM 
10/16/2012 9:31:21 PM 
10/16/2012 9:31:21 PM 
10/16/2012 9:31:24 PM 


wanna tenor WANO EEE ena A 


Creating or Updating report: User Summary for a User Group 
Mapping Report: User Summary fora User Group 
Creating or Updating report: visited Sites 

Mapping Report: visited Sites 

Creating or Updating report XenApp Server Utilization 
Mapping Report: Xen4po Server Utilization 

Creating or Updating report: User Lagan Counts 
Mapping Report: User Lagan Counts 

Creating or Updating report: xenDesktop Summary 
Mapping Report: XenDesktop Summary 

Creating or updating report XenDesktop User Summary 


Mapping Report: XenDesktop User Summary 


Cleaning standard reports: fCitrixfEdgeSight?DAD?T 920-94 35-465D-BF835- 
4o2D2E5F9690/Detault 


Cleaning standard reports: fCitriyvEdgeSight'?OADT920-94C5-465D0-BF83-46202E 3F 9690/0 PS 
Loading default schedules.. 


Configuration completed successfully, 


http: fedgesight 1 fedgesight/app/smar/modalwrap.asp |E. Local intranet | Protected Mode: OFF 





If the Reporting Services Configuration Status - Webpage Dialog window does 
not appear and times out after 20 minutes, there is a delay in communication from 
the EdgeSight web server with SQL Server Reporting Services. If this happens then 
ensure that the SQL Server Agent service is in started state. This is required for 
publishing the schedules. 
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3. Verify that the default departments were created successfully by navigating to 
Configure | Company Configuration | Device Management | Departments. 





Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage | Browse | 


Bookmark Tis Fae eich Prnt 











Agents 

Alerts [ New Department |] [ Department Cleanup Wizard | 

Device Management Department Alert Rules Agent Workers Agent Properties 
Devices All XenApp Default Xe Default 
Departments XenApp Farms 13 XenApp Default KenApp Default 
Groups Farm60 WA XenApp Default KENA ult 

User Groups Farm65 WA KenApp Default Mend ult 


Real-Time Dashboard 
Security 


IP Ranges 


Application Categories 


Vendors 


Settings 














The All root department and the XenApp Farms subdepartments are created by 
default during the EdgeSight installation and are usually referred as the default 
departments. The default departments cannot be renamed, moved, or deleted 
but we can modify their worker and agent properties. 


The subdepartments override configuration settings inherited from parent 
departments. If you have two alerts mapped to the All department and three are 
mapped to a subdepartment, then that means that a total of five alert rules will be 
applied to this subdepartment. 


j You can create departments based on the type of application 
i published on the XenApp server such as the Office 2007 
Q servers, the Office 2010 servers, the geographical location of 
the server, or any other hierarchical structure. 


4. After installing the EdgeSight agent and rebooting the XenApp server you will receive 
an e-mail from the EdgeSight Server that a new instance has been discovered. Verify 
that you start getting those e-mails. The following screenshot displays the e-mail 
received from the EdgeSight Server after a new device gets registered with it: 


Instant EdgeSight for XenApp 





EdgeSight - New Instance - Machine: "XENAPP65-3' Domain: 'PACKT-PUB' 


EdgeSight@packt-pub.net 


sent: Fri 10/19/2012 3:33 PM 
Alerts 





New EdgeSight Instance Information: 


Machine: XENAPP65-3 

Domain: PACKT-PUB 

IP Address: 192.168.1.126 

FQDN: XenApp65-3.packt-pub.net 
Assigned Company: PacktPublishing 


Assigned Department: All\XenApp Farms\Farm65 
WebServer: EDGESIGHT1 





To view more detailed information visit: Devices. 





5. Navigate to Configure | Company Configuration | Device Management | Devices to 
verify that the XenApp servers on which the agent has been installed start to appear 
in the EdgeSight console. 








Getting Started Monitor Troubleshoot Plan and Manage Track Usage OWS e Configure 


Company Configuration A © Department or © Group: | All “| I Root only 
Go | 








Agents Filter: | O By Device C By Domain C By User Name 
Alerts 
Show: [Model/Speed z] 
Device Management 
Fee Show:|25 _*|Items:[i to 5 (of 5) 
Departments E Device Domain Model #@MHz Last Upload © 
Groups E XENAPP65-3 PACKT-PUB VMware Virtual Platform 2@ 2300 10/19/2012 3:33 PM 
User Groups O XENAPP65-1 PACKT-PUB Virtual Machine 1@ 1995 10/16/2012 10:29 PM 
Real-Time Dashboard C] KENAPP65-2 PA.CKT-PUB Virtual Machine 1@ 2009 10/18/2012 10:21 PM 
Security C XENAPPÉQ-2 PACKT-PUB VMware Virtual Platform 2@ 2300 10/18/2012 10:10 PM 
a XENAPP60-1 PACKT-PUB Virtual Machine 1@ 1995 10/16/2012 10:06 PM 


IP Ranges 


Application Categories 
Vendors 


Settings 


License Monitor Configuration Nf 
Server Configuration YA 








6. Verify the EdgeSight Server's license status by navigating to Configure | Server 
Configuration | EdgeSight Licensing. 


If a XenApp agent licensing violation has occurred, then the following 


~ R message will be displayed: 
EdgeSight has detected a problem with Licensing. Click here for more 


information. 
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T. Verify that you only upload the data from the agents to the EdgeSight database that is 
important to you. Navigate to Configure | Server Configuration | Data Maintenance 
| Upload Configuration to make your selection according to your requirements. 


An important message is displayed at the top of the page, informing the 
> administrator that the amount of data uploaded to the server directly 
impacts the size of your database and the performance of the server. The 
server will run faster and will be able to Support more devices if you do 
not upload data that is not important to you. 





A single server can Support multiple companies. Companies are broken down into departments. 


To display the most recent messages related to server maintenance jobs, events, or the 
registration of new agents, browse to Server Status | Messages. 


—_ E 
is) CITRIX | EdgeSight 
Getting Started Monitor Troubleshoot Plan and Manage Track Usage kova Configure 


My Settings = v | Bookmark This Page Refresh Print 
pees a 
A 


Server Status No data available. 


Server Script Host 
Grooming Log 
Job Status 

Job Log 


About 





Modifying the e-mail notification settings 


You must provide a valid SMTP server name or IP address as the EdgeSight Server uses e-mail 
for alerts and error event notifications. 


In case you ever need to go back and modify the e-mail notification settings for a company in 
EdgeSight, navigate to Configure | Server Configuration | Settings | Notifications. 
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Getting Started Monitor | Troubleshoot | Plan and Manage Track Usage Browse Configure | 


My Settings ka 
Company Configuration x 
License Monitor Configuration -r Agent Support Agent Database Broker Notifications Timeouts Data Upload Crash Processing SSL SNMP 
Server Configuration a SMTP Server: [192,168,1.110 Test Email | 


Address of SMTP server used to send email from EdgeSight Server, 
Status te 


SMTP Pott: [25 


Port of SMTP server used to send email from EdgeSight Server, 


Reporting services EdgeSight Server: |EQGESIGHT1 


EdgeSight Licensing The EdgeSight server name. 


Authentication Administrative Email Address: |Alerts@packt-pub.net 


The email address to which EdgeSight Server should send administrative emails. 








Bookmark This Page Refresh Print 





Settings 


Data Maintenance 


Email From Address: i - 
Companies lEdgeSight@packt pub.net 


The default “from” email address for all mail sent from EdgeSight Server. 


Language: [English x] 


Language of email sent from EdgeSight Server. 


New Agents: [Send Email z] 


Send an email when a new agent is registered with the EdgeSight Server (recommended), 


Agent Errors: [Send Email “| 


Unmanaged Devices 


Server Status x 








Send an email when an agent error occurs (recommended), 
Server Errors: [Send Email + | 
Send an email when a server error occurs [recommended], 
Communication Errors: | Log Message + | 
Write a database message when an agent communication error occurs (recommended), 


Bad HTTP Payload Read: | Do Nothing + | 


Send an email when there is bad HTTP read of a payload (not recommended). 


Attach Payload: [No -] 


Attach the payload (if available) when an error occurs (not recommended). 


Save Changes | 











Before saving your changes you must also test the communication with your messaging server 
by clicking on the Test Email button. 


1 
Q Based on your SMTP server and its version, you might also need to 


configure you SMTP server to allow the EdgeSight Server to send an e-mail. 


Configuring users, groups, and 


authentication (Intermediate) 





After you've completed the EdgeSight Server installation and configured the server setting, it 
is time to create users, assign groups, and configure an authentication provider. In this recipe 
we will use Active Directory as the authentication provider. 





Getting ready 


Before creating a new Active Directory as the authentication provider we need to get the LDAP 
path. The LDAP path is formulated as LDAP: //DomainName. com. 
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How to do it... 


1. To configure an authentication provider, browse to Configure | Server Configuration 
| Authentication and click on the New Provider button. 








Getting Started Monitor | Troubleshoot Plan and Manage Track Usage Super User | Help | Log Off 


Bookmark This Page Refresh Print 























| New Provider | Default; | Active Directory Y 
D Mama a | Description | Default | Prowidies Type mz. 
Status C] SY Active Directory Active Directory Yes Active Directory 
Email Default Email authentication provider No Email 


Settings 


Reporting Services 


EdgeSight Licensing 
Authentication 
Data Maintenance 
Companies 


Unmanaged Devices 














The default authentication provider that is created with the installation 
yaa of EdgeSight cannot be edited or deleted. 
2. Select Active Directory from the list of authentication provider and click on Next. 


Enter a name and description to identify the provider. If you want to configure this 

as the default authentication provider then also select Make this the default 
authentication provider. Also enter the LDAP path with the appropriate user 
credentials and then click on the Test button. After the message The test completed 
successfully, click on the Finish button. 
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Step 2 - Configure the authentication provider 


Name: [active Directory 
Description: [active Directory 


|” Make this the default authentication provider 


LDAP Path: [LDAP:/packt-pub.net 


The account specified here is used to query Active Directory for users and groups. Both the account name and the password will 
be stored in the database. The password will be encrypted. You should not use an account whose password may expire. If the 
password expires, you will not be able to add Active Directory users and groups to EdgeSight Server and logins may begin to 
fail. This account is not used to authenticate users to EdgeSight Server, A users own user name and password will be used 
during the authentication process, The user name can be in one of the following forms: 


e NT Domain (29. yourdomain\username] 
èe User Principal Name fag. wsername@yourdamaincam| 
@ Distinguished Name (eg. ch=username.cn= Users dc= vourdamain,dc=cam| 


NOTE: The examples above will have to be modified to reflect your Active Directory structure, 


User Name: [packt-pub\administrator 
Password: Jeceecees 


The test completed successfully 


Refresh | = Back | Finish | Cancel | 





4. Now we will create a new user in EdgeSight using the Active Directory User Picker and 
select a user from our Active Directory domain. To do this navigate to Configure | 
Company Configuration | Security | Users and then click on the New User button. 


(Ge) CITRIX | EdgeSight 


Getting Started | Monitor Troubleshoot Plan and Manage Track Usage Browse Contigure 





| Bookmark This Page Refresh Print 


Department: | all =| T Root only 
AA Go | 
Agents Filter: | fe By Name 


Alerts 
elat | New User | Cleanup Wizard | Show: [2s =] Items: RR to 1 (of 1) HA EJ E 
Device Management ww ananiona : > AEE AEE MWASI Pae aa aa aa AA 
Saisie : Tg ~ i | 
User Groups Bee Bane. KAM e pegarte: WA D E ATC WA TAGE TEEN] 
eh Pohl ant All 10/19/2012 12:02 PM 
Real-Time Dashboard vo Provider: Email f19/ 


Security 

Users 

| Roles 

Farm Authentication 
IP Ranges 
Application Categories 
Vendors 
Settings 


License Monitor Configuration 


Server Status 
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5. Select Active Directory as the authentication provider and click on Next. 


6. Click on the Browse button to select User or Group from the Active Directory User 
Picker window. 


T. Select the appropriate type as Users, Groups, or Users and Groups from the Type 
drop-down menu and click on the Go button to populate the list from Active Directory. 
Select the User or Group value you want to assign the permissions to and click on 
OK. Here we have selected the Domain Admins group. 





g| EdgeSight Server -- Webpage Dialog 


Active Directory User Picker 
Enter a filter and pr 30 to search Active Directory for users and/or groups, Use the * character for wildcard matching. 
A maximum of 100 entries w - 


Type: [Users and Groups “| 
Go| 
Filter: | O By Account C By Name * By Description 






Account Name Description 
: ~ 
f Alerts Alerts a 
Backup Operators can override security restrictions for 
€ Backup Operators Backup Operators the sole purpose of backing up or restoring files 
; i Members of this group are permitted to publish 
E Ser PUDINS Seri Publishers certificates to the Active Directory 
WA APAA Members are allowed to launch, activate and use 
@ Distributed COM Users Distributed COM Users Distributed COM objects on this machine. 
Œ DnsAdmins Dns&dmins DNS Administrators Group 
DNS clients who are permitted to perform dynamic 
@ DnsUpdateProxy DnsUpdateProxy updates on behalf of some other clients (such as DHCP 
servers), 
@ Domain Admins Domain Admins Designated administrators of the domain 
#4 Domain Computers Domain Computers All workstations and servers joined to the domain 
@ Domain Controllers Domain Controllers All domain controllers in the domain 
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Domain Guests Domain Guests All domain guests -| 
o| Cancel | 


http:/fedgesight1 fedgesight/app/smar/modalwrap. aspx? Local intranet | Protected Mode: Off 





| 





8. Click on the Save L-] button to select the role from the Role Picker pop-up window. 


Add a new user 


User Info 


User or Group Name: [Domain Admins Browse... | 
Company Roles 
Roles Department 


Mea  &«f 


User Permissions 


Deny 


Manage Server Settings 


Allow >> | 
Der | 


Refresh < Back | Finish | Cancel 
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9. Select the role you want to make this new user a member of and click on OK. You will 
be then returned to the Add a new user web page. 


FY EdgeSight Server -- Webpage Dialog 
Role Picker 





Members of this role have full control over the system, 


[ Report viewer Members of this role can only views reports, 


E License Server Monitor 
Administrator 

License Server Monitor 
E 


Members of this role can wiew the License Usage reports and edit the configuration, 


aeie Members of this role can only views License Usage reports and status, 


ok] Cancel | 
http: edgesight 1 fedgesight/app/smorfrmodalwrap, aspx? Lie Local intranet | Protected Mode: OFF | 





10. Select user permissions to be granted to the user from the Deny list box and click on 
Allow to grant the permission. 


11. Click on Finish and verify that the new user you created now appears in the list. 








Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage | Browse | Configure Super User | Help | Log Off 


Bookmark This Page Refresh Print 












































i Department: | All v| | | Root Only — 
8 Go 
Agents Filter: | | © By Name 
Alerts 
New User | | Cleanup Wizard Show:|25 Y | Items: to 2 (of 2) [J [J E] 
Device Management — 
Last Sign 
User Groups a Name A Department On 
ji ~ Domain Admins 
Real-Time Dashboard o% Provider: Active Directory All 
A =~ User, Super 7/22/2013 
— GE provider: Email An 11:04 PM 


Users 
Roles 
Farm Authentication 


IP Ranges 


Application Categories 


Vendors 


Settings 
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Let us now see how to manage groups. 


The User Groups page enables you to create collections of users by directly selecting users 
by username, IP address, IP range, or by running a query against the EdgeSight database. 
The examples of groups include common operating systems and common hardware: 


1. To create a group, browse to Configure | Company Configuration | Device 
Management | Groups and then click on the New Group button. 














Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage | Browse | Configure | 
Bookmark This Page Refresh Print 
Filter: @' By Group (Go. 
Agents 
Alerts | New Group _ Show: 25 v Items: to 11 (of 11) SEI BI 
Device Management Group 4 Devices Refresh Rate Expires Last Modified By Last Modified 
Devices $ E All Windows 2000 0 4h00m Super User 10/21/2012 10:45 AM 
Departments & E All Windows 7 O 4h00m Super User 10/21/2012 10:45 AM 
Groups @ E All Windows Server 2003 0 4h00m Super User 10/21/2012 10:45 AM 
User Groups $ E All Windows Server 2008 0 4h00m Super User 10/21/2012 10:45 AM 
Real-Time Dashboard @ E] All Windows Server 2008 R2 5 4h00m Super User 10/21/2012 10:45 AM 
Security @ E All Windows Vista 0 4h00m Super User 10/21/2012 10:45 AM 
IP Ranges $ E] All Windows XP O 4h00m Super User 10/21/2012 10:45 AM 
Application Categories $ E] Citrix XenApp 5 4h00m Super User 10/21/2012 10:45 AM 
Vendors $ [E] Desktops 0 4h00m Super User 10/21/2012 10:45 AM 
Settings $ E] Laptops 0 4h00m Super User 10/21/2012 10:45 AM 
SY Terminal Servers 5 4h00m Super User 10/21/2012 10:45 AM 














The groups in the previous screenshot were created automatically during the 
installation of the EdgeSight Server. 


2. Enter a name for the group and click on the Create a Group button. 


New Group 
Group Name: 


Expires After: 1 Month Fr 


Groups are configured to automatically refresh their device cache on a set interval. 
On what interval would you like this group to refresh? 


Refresh this group every 4 Y hours 0 * minutes 


Groups that you create can be made available to other managers in your company. 
Would you like to make this a public group? 


@ Yes, make this Group available to other managers 


No, make this Group available only to me 


Ri Take me to the Add Members page 


Create a Group | Cancel | 
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The expiration period is the time after which this newly created group will 
automatically be deleted. This feature facilitates the management of groups created 
for short-term projects with a set duration, such as the evaluation of software. Groups 
can also be set to never expire. 


The refresh period refreshes the device cache. This refresh rate generally provides 
you with sufficient currency of data without performing unnecessary cache refreshes. 


If you do not create the Active Directory authentication provider, you can still use the default 
authentication provider (Email) that is installed with the installation of the EdgeSight Server. 
The default authentication provider uses an e-mail address as the username: 


Add a new user 


User Info 


First Name Wagar Last Name [Hasan 
Email \vaqarhasan@packt-pub.net 


NOTE: An email will be sent to the user explaining the sign in process and providing a temporary password, 


Company Roles 
Roles Department 
Administrator ea All 


User Permissions 








Deny 





Refresh | < Back | Finish | Cancel | 
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When you create a new user, you will have to provide the e-mail address for that user. Then 
an e-mail is send to the user explaining the first-time login process and also providing a 
temporary password. When the user first logs in, they are requested to change their password. 













# Sign-In Help For EdgeSight Server - Windows Internet Explorer Pale! E3 
http: ff fexchange/vaqarhasan/Inbox/Sign-In%20Help%>20For %20EdgeSsight%20S5erver. EML?Cmd=oper bea 
À Reply to all Forward G A O 2h K & & O Help 
From: EdgeSight@packt-pub. net [EdgeSight@packt-pub.net] Sent: Sun 3/17/2013 10:15 PM 
To: vagar Hasan 
Gr 
Subject: Sign-In Help For EdgeSight Server 
Attachments: 





Thank you for using EdgeSight Server. 
EdgeSight Server Password: MC2hpl897 


To log into EdgeSight Server, go to: http: //EDGESIGHT l/edgesight/app/suilogin. aspx? 
em=vagarhasan%40packt-pub.net 


If you have received this mail in error then you can safely ignore it. Someone must have entered 
an e-mail address incorrectly. 


Thank You 


EdgeSight@packt-pub.net 











There's more... 





Once you have configured Active Directory as the authentication provider, then the users or 
groups you assigned the permissions will be able to log in to the EdgeSight website using their 
Active Directory credentials. 





Defining alerts (Advanced) 


Citrix EdgeSight alert is a powerful rules- and actions-based system that instructs the 
EdgeSight agents to send an alert in real time when a predefined situation has occurred on a 
monitored object. Alerts are defined by rules. 


The action can be configured to send either an e-mail alert or SNMP trap. The generated 
alerts are also listed and organized within the EdgeSight web console. 


After an alert rule has been created, it should be mapped to a department. 
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How to do it... 





1. To create an alert, navigate to Configure | Company Configuration | Alerts | Rules 
| New Alert Rule. 





Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage | Browse | Configure 


Company Configuration a 
Agents Delete | New Alert Rule | Show:|25 —) Items: fi to 15 (of 15) 











| | 
Alerts IC Alert Rul | Rule Type #Depts | Last Modified By | Last Modified | 
Rules ~ Configuration Logging Database Configuration Logging Database 10/18/2012 
OY @ Unaailabie Unavailable 1 User Super 9:21 PM 
Ations E > ae store connection Farm Data Store Connection Failure 1 User, Super neon oa 
Suppressions > Health Monitoring and Recovery Health Monitoring and Recovery 10/18/2012 
Device Management 0 a Action Failure Action Failure 1 User, Super 9:21 PM 
= Health Monitoring and Recovery Health Monitoring and Recovery Test 10/18/2012 
ueeniersups TOE Test Failure Failure 1 EBL Super 9:21 PM 
Real-Time Dashboard L] g IMA Service is Unresponsive IMA Service is Unresponsive al User, Super BI 
, By P A : ; A A 10/16/2012 
Security E E] License Server Connection Failure License Server Connection Failure 1 User, Super 9:21 PM 
IP Ranges LI $y ARA Servers in a Zone is kai of Servers in a Zone is too 1 User suner BA 
Application Categories = Published Application Concurrent Published Application Concurrent 10/16/2012 
E D Usage Limit Usage Limit 1 User, Super 9:21 PM 
Vendors 
O > Session in Down State Session in Down State al User, Super I 


Settings 10/24/2012 


a S&S System Slowdown System Slowdown 1 - , 
License Monitor Configuration v 8:07 PM 

= gy Terminal Server Client Connection Terminal Server Client Connection 1 u 5 10/16/2012 
Server Configuration wA Error Error SLEE, 9:21 PM 


= Terminal Server License Server Terminal Server License Server 10/18/2012 
= 0 Discovery Failure Discovery Failure 1 User, Super 9:21 PM 














2. Wewill create an alert rule based on an application, so select the Application Alerts 
radio button and click on Next. 


3. Select Application Performance as the alert type and click on Next. 


4. Give the alert rule a name, the name of the process we want to monitor, and the CPU 
time in percent. Click on Next. 


Alert Rules Creation Wizard 


| Define Alert Rule Conditions 





Define the conditions that will cause this alert to fire, then click ‘Next’. Mandatory parameters are denoted with a red star. Parameter sets marked 
with blue stars must have at least one provided. Click ‘Cancel’ to end the wizard without saving changes. 


Rule Type: Application Performance 


Rule Name: [Inte rnet Explorer 80 Percent CPU 


Standard Parameters 


Process file name iexplore.exe AA |” Not like 
Process company name |” Not like 

+ CPU time (percent) 00 

+ Private bytes allocated [KBytes] COT 

+ Handle count 

+ Page faults per second 

+ Thread count [CT 

+ Thread queue length | 


Advanced parameters are available, Click here to view them... 





* — Indicates a required parameter. 


* — Indicates a parameter from a set where at kast one is required. 





Next > | Finish | Cancel | 
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5. Select departments to assign this alert rule to and click on Next. 


6. Select the department you wish to edit alert actions in and click on Next. 


Alert Rules Creation Wizard 


| Assign Action to Alert Rule 





Select the Department you wish to edit Alert Actions in, and click ‘Next’. Alerts need to be mapped to a department before being assigned an 
alert action. Click ‘Cancel’ to end the wizard without saving changes. 








We now need to assign an action to this alert rule; we will create a new action. So 
select the Create New Alert Action radio button and click on Next. 


8. Wewill send an e-mail notification as the alert action so select Send an email 
notification radio button and click on Next. 


Enter a name, subject, and one or more recipient e-mail addresses for this e-mail 
action. You can click the Test Action button to test whether EdgeSight was able to 
successfully queue the message or not. Click on Finish. 


Alert Rules Creation Wizard 
| Create New Alert Action 


Enter a name, subject, and one or more recipient email addresses for this Email Action. Email addresses may be entered by selecting them from 


the known Email combobox of typing them in the To: field directly, separated by semicolons. Click ‘Next’ to continue, ‘Back’ to select a different 
Alert Action type, or ‘Cancel’ to end the wizard without saving changes. 


Name: EdgeSight Email Notification 
Language: English (United States) 


Queuing: [ ] Queue notifications for minutes 


Existing Addresses: | Administrator®packt-pub.net 


Administrator® packt-pub. net 


Subject: EdgeSight Email Notification 


Test Action 


Test queued successfully. Please check the addressed mailbox to ensure that the message arrived, 





[cones] 
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Creating too many real-time alerts can affect the XenApp server performance as each 
rule that is created requires more work to be performed by the agent. 


We should only create alerts for those critical situations that require immediate action. 
If the situation is not critical, the delivery of alerts based on the normal upload cycle 
will probably be sufficient. 


By default, the alert data and other statistics are uploaded to the server daily. 


There's more... 





When a new alert rule is created or any existing rule is modified, this change is applied to all 
the devices in the department when those devices next upload data to the EdgeSight Server; 
alternatively, you can manually upload the alert rule data by clicking on Run Remotely. 


Administrators can also force certain agent devices to perform a configuration check within 
the EdgeSight web console by navigating to Configure | Company Configuration | Agents 
and then selecting the device from the device picker. 
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_ Bookmark This Page Refresh Print 














Agents Run Workers Remotely — Device: | $a 





Workers From this page it's possible to start an EdgeSight worker on the selected machine. Workers perform many different tasks and normally run according 


Properties to the schedule set for that worker, Click here to edit worker schedules for a department. 


= Status: No device selected 
Alerts 
Device Management 


User Groups 


Real-Time Dashboard 


Security 


IP Ranges 
Application Categories 
Vendors 


Settings 











We can also temporarily prevent certain types of alert that match a criterion from being 
displayed on the console using Alert Suppression. 
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To suppress an alert, navigate to Monitor | Alert List, click on the down arrow ka and then 
select Suppress Alert. 


To clear an alert navigate to Configure | Company Configuration | Alerts | Suppressions. 
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Bookmark This Page Refresh Print 





Agents Show:|25 “| Items: to 25 (of 0) E9 E3 EJ E 


Alerts |) Source Device User Alert Count 











Rules No data available. 
Actions 
Suppressions 

Device Management 

User Groups 

Real-Time Dashboard 

Security 

IP Ranges 

Application Categories 

Vendors 


Settings 














This is per user basis and other EdgeSight administrators will still see those alerts Suppressed 
by you. 


Managing the real-time dashboard 


(Intermediate) 





The EdgeSight dashboard provides a comprehensive view of the XenApp server's health state 
in real time. The dashboard queries the agent databases for counter values based on the 
configuration created by the EdgeSight administrator. 


Getting ready 


To populate the dashboard, we first need to create a new real-time configuration. Each 
configuration defines what counters will be displayed in the dashboard. We can create 
multiple configurations and each configuration will have its own devices. A device can 

be a member of multiple configurations. 


How to do it... 
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1. Logon to the EdgeSight website, navigate to Configure | Company Configuration | 
Real-Time Dashboard, and then click on the New Real Time Configuration button. 


Getting Started Monitor Troubleshoot Plan and Manage Track Usage 


[Settings | Banka isn Ree nk 


Browse 


Configure | Help | Log Off 


== 








My Settings a | 


New Real Time Configuration 





Agents ; 
iL) Configuration Name 2 


Show: Items: to 25 (of 0) 


| Devices | Last Modified By Last Modified | 








Alerts 
ji No data available. 

Device Management 

User Groups 

Real-Time Dashboard 

Security 

IP Ranges 

Application Categories 


Vendors 


Settings 





2. Enter a name for the configuration, verify that Take me to the Add Devices and 
Counter wizard is checked, and then click on the Create the Configuration button. 


New Real Time Configuration 
Configuration Name: Office201 OServers| 
Query Timeout: 5 seconds 
Connection Timeout 5 seconds 


Update Interval: 15 * seconds 


Take me to the Add Devices and Counters wizard 


Create the Configuration 
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3. This takes us to the Edit Devices screen. To populate the list, click on Go button and 
then double-click on the device name to add it to the Configuration Members list. 
Click on Next. 


Edit Devices - Office2010Servers 
Existing Devices 
Select a department and enter a filter (© Department or L Group: All = 
Siring fo deploy OECS =.. O 
Filter 
All devices in Alf 


Use existing devices to help select members for this configuration 


MENAPP6O-1 
MEHAPPSO=2 
XENAPPS5-1 
MENAPPG5-2 
MEN APPS5-5 


PACKET-PUB 
PaCkKT-PUB 
PACKT-PUB 
PACKT-PUB 
PACET-PUB 


5.3.4101.0 
5.3.4101,0 
54.0.5107 
5.4.0.51107 
54.0.5107 


Double-click a device to add 


to 5 tot SE 


Show 25 * Jjtems: 1 


Configuration Members Members: 
KENAPPSO-1 [5.3.4101.0) 
KEHAPPSO-2 [5.3.4101.0} 
XEHAPPES-1 (5.4.0.5107) 
MENAPPS5-2 (5.400.510 


| Select All 


| Refresh | 
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CAN Each configuration can contain a maximum of 20 devices and each 
J configuration can only monitor a maximum of 8 counters. 
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4. Checkmark the counter that you want to monitor and enter the threshold value for 
that counter. Click on Next and then click on Finish. 


Edit Counters - Office2010Servers 


Performance Counters 

CPU 

vl % Privileged Time 

| % User Time 

Fl Privileged Time secs 

| User Time secs 

Memory 

“| % Committed Bytes In Use 
ial Page Faults perSecond 
T| Pool NonPaged KBytes 
TCP 

4] Current Connections 

7] Reset Connections 

T] Segments Retransmitted 
Disk 

Y) % Disk Time 

T| Disk Kbytes per Second 
| Context Switches per Second 
_| Processor Queue Length 


XenApp Counters 
Session Counts 
| Active Sessions 


[E] Total Sessions 


T] Peak ICA Round Trip Time 


| Refresh | 


40 J 
A 5 
LU second(s) 
10 second(s} 
40 J 
100C jec 
| KB 
30 connection(s) 
j connection(s) 
LO Jec 
40 5 
I KB / sec 
10000 sec 
threads} 
Threshold 
40 sessions) 
St sessions) 
100 ms 
10 ms 


| % Total Processor Time 
|| Inte mupts per Second 


F] Processor Time secs 


T] Committed Kbytes 
F Fages Input per Second 
T] Pool Paged KBytes 


| Failed Connections 


| Segments Received per Second 


| Segments Sent per Second 


| Current Disk Queue Length 


|| Process Count 
F System Calls per Second 


| Inactive Sessions 


F] Average Network Round Trip Time 


T| Peak Network Round Trip Time 


Threshold 


Bo 


LU {SBE 


10 second(s) 


{SEC 


connections) 
ISE 


rset 


request(s) 


process[es) 


AU | fee 


Threshold 


ZL Sess iors) 


ms 


ms 


| < Back | | Next> | | Cancel | 





5. Click on the name of the configuration you just created. In this case it is 


Office2010Servers. 
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6. Click on Start Updating. To stop querying the devices, click on Stop Updating. 





Dashboard Stop Updating Hide Legend 
a > 100% of threshold 3 75-100% of threshold .” < 75% of threshold = No data available _) Error retrieving data 
Counter Name Threshold 
Status: Started a Ẹ 
Last Updated: 15:18:18 £ 5 E F e > % Privileged Time 40 % 
= 5 % C itted B In U 40 % 
Updated 5 of 5 Devices z = g o |S |2 H > SINE Bees IMASE 
x = £ é o i4 > Current Connections 30 connection(s) 
F 
$ |E |o ite ie |8 le 
> z © |% 3 v Oo > % Disk Time 40 % 
E S |5 |â |$ EA > Context Switch Second 10000 / 
s |£ F- s | 3 z ontext Switches per Secon sec 
f XenApp60-1.packt-pub.net ð ə ə ə ð ə ə > Active Sessions 40 session(s) 
= > Average ICA Round Trip Time 100 ms 
ø  XenApp60-2.packt-pubnet @ QB 9 999 9 
J  XenApp65-Lpackt-pubnet 9 ®© 9 9999 
øJ  XenApp65-2.packt-pubnet 9 ®© 9 999 9 
J KenApp65-3.packt-pub.net @ a 0. p © ọỌ © 











There's more... 





If the threshold for a device consistently exceeds your defined threshold, you may use the 
device troubleshooter icon a” to further investigate the root cause of the problem. 


Working with EdgeSight reports 





(Intermediate) 


EdgeSight reports are based on the data stored in the agent database as well as the server 
database. The reports can be historical as well as real-time. In case of real-time reports, the 
data is pulled directly from the agent database. 


In this recipe we will subscribe to a report and configure it to be delivered via an e-mail. 





Getting ready 


EdgeSight comes with a wide range of built-in reports. We can download these reports and/or 
export them to a variety of different formats. We can also add our own custom reports to 

the report server. One great feature that EdgeSight also offers is the automatic delivery of 

the report of our choice to run at a custom schedule; the report is sent to a specific folder or 
e-mail addresses. 
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How to do it... 


1. First we need to verify that the e-mail settings for the Reporting Services are configured 
properly. Log on to the server hosting your reporting services, open the Reporting 
Services Configuration Manager, and then select Email Settings. By default the 
Sender Address and SMTP Server fields are not populated automatically. After entering 
the appropriate information click on Apply. 


l 
Q The Sender Address field should be a valid e-mail address and appears 


as the address of origin in the e-mail. 





Be Reporting Services Configuration Manager: EDGESIGHT 1\,MSSQLSER¥YER 


Microsoft SQL Server 2008 Reporting Services 
Reporting Services Configuration Manager 


E-mail Settings 


J EDGESIGHT 1\MSSQLSERVER Ka To use report server e-mail, specify an existing SMTP server and an e-mail account that can send e-mail | 
= From that server, 





x Service Account 


JẸ Web Service URL SMTP Settings 


To edit, change the Fields and click the Apply button, 











pD Database 
Sender Address; [administrator@packt-pub.net 
E) Report Manager URL 
Current SMTP Delivery Method: [Use SMTP server 
O k sl . 
3 E-mall Settings SMTP Server: [192.168.1.110 - 
je ai ii ofl 





A Execution Account 


cretion SSS 


T) Apply Sender E-Mail Settings 


¿7a Scale-out Deployment Your configuration has been updated with your new e-mail information, 








A! Ensure that SMTP relaying is permitted by your mail server and that it 
Q also allows the EdgeSight Server to relay mail; otherwise, the recipients 
will not receive e-mails from the EdgeSight Server. 
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2. Open the EdgeSight website, navigate to Configure | Server Configuration | 
Reporting Services | Schedules, and then click on the New Schedule button. 
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My Settings v | Bookmark This Page Refresh Print 
Company Configuration a 
License Monitor Configuration v New Schedule Show:}25 x 

















Server Configuration A Description Last Run 
At 3:00 AM every Mon, Tue, Yved, Thu, Fri of every week, starting 
Status O & Every Week Day 3/31/2013 Never 
ve E > Friday At 3:00 AM every Fri of every week, starting 3/31/2013 Never 
Reporting Services 
E SY Monday At 3:00 AM every Mon of every week, starting 3/31/2013 Never 
Report Server 
Schedules C] YS Thursday At 3:00 AM every Thu of every week, starting 3/31/2013 Never 
EdgeSight Licensing L] a Tuesday At 3:00 AM every Tue of every week, starting 3/31/2013 Never 
Authentication E YS Wednesday At 3:00 AM every Wed of every week, starting 3/31/2013 Never 
Data Maintenance 
E > Weekly Archive At 3:00 AM every Sat of every week, starting 3/31/2013 Never 


Companies 


Unmanaged Devices 


Server Status ae 














3. Specify a name for the schedule and specify other details as per your requirement. 
Click on the Add Schedule button. 


Add New Schedule 


Name; [Daily Alerts Reports 
Schedule Details 


Schedule Type: | Daily “| 


(* Onthe following days: 

M sun M Mon M Tue M wed M Thu M Fri M Sat 
% Every weekday 
C Repeat after this number of days: 


Starttime:|03 foo 


Start and End Dates 
Begin on: [2013-0402 =j 
1” Stop on: | =| 


Add Schedule Cancel 
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The start time is based on a 24-hour clock. 
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4. Click on the Browse tab and the Subscriptions link of the report you want to 
subscribe to. 














Configure 





Monitor 








Getting Started Troubleshoot Plan and Manage Track Usage 
| ; | | Bookmark This Page Refresh Print 
| Sort by: Name a 
Alerts c 


Number of alerts by type with alert details. 


Properties - Download § Subscriptions 














5. Click on the New Subscription button to create a new subscription. 


6. The default delivery is through e-mail; in case you want to save the report to a 
specified folder, you can click on the Delivered by drop-down menu and select 
File Share. To select the schedule, click on the Schedule drop-down menu and 
select the schedule you want the report to be processed at; click on the Create 


Subscription button. 


Create new subsoiption for: Alerts 


Delivered by: 

language 

Visibility: @) Public C Private 
Delivery Options 

To: Administrator@ packt-pub.net 


id 


{Use “" to seperate multiple email addresses) 


Subject @RepontName was executed at @Executionlime 


Format: 


_ AAA. 


Processing Options 

Report Parameters 
(®) Department or | Group: LI Root Only 
Group By: Then Group By: 


Optional Parameters 
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There's more... 





The built-in reports provided by EdgeSight can be modified to meet the business requirements 
more closely. To modify a report, click on the Download link and save the file with the default 
extension of .RDL (Report Definition Language). Then use your favorite XML Editor to open the 
. RDL file and change the SQL query within the <CommandText> tag. You might also need to 
modify the field names <Field Name> and the data fields <DataFields> tags. Once done 
save the file, navigate to Configure | My Settings | Custom Reports, and then click on the 
Upload button. 





„Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage | Browse | Configure 
































Profile 
Upload Custom Report 
Favorite Reports 
Subscriptions Report: Browse... 
Path to the report definition file for the report. 
Custom Reports 
Name: 
lame of the report as will be shown in the EdgeSight Server console 
Description: ] 
| 
Optional description of the report that will be shown on Browse page. 
Visibility: | Public V 
A public report can be viewed by other EdgeSight Server users. A private report is only viewable by you. 
Permissions: || view Alert Reports 
|_| View Device Reports 
[_] View Network Reports 











|View Process Reports 





L | View XenApp Reports 
Permissions required to view the report. If no permissions are selected, the report will viewable by any EdgeSight Server user. 


Cancel 























If you set the visibility to Private, then only the user uploading the report can view it. 


; Citrix EdgeSight Reporting wiki is a collaborative authoring web encyclopedia 
< project that has several reports with real-life scenarios and other helpful 
Q EdgeSight product information. It is available at the following link: 


http://community.citrix.com/edgesight/ 


Monitoring the Citrix license usage 





(Intermediate) 


EdgeSight can report the usage reported by the Citrix License Server for all types of Citrix 
licenses used in the organization. 


In addition to Citrix licensing, EdgeSight can also display published application usage and 
session durations with both summary and detailed information. These reports are also 
available from the Browse tab. 
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Getting ready 


To monitor your Citrix licensing server, the version of the licensing server should be at least 11.9. 





How to do it... 


1. We must first specify at least one Citrix License Server by navigating to Configure 
| License Monitor Configuration | License Servers and then clicking on the New 
License Server button. For the license server name we can specify either the IP 
address or the FQDN of the license server. 


Getting Started Monitor Troubleshoot Plan and Manage Track Usage Sa Configure Super User | Help | Log Off 








Bookmark This Page Refresh Print | 





192.168.1.110 


| EnterpriseA | 


27000 
| Test Connection | 


Update License Server 


























2. To configure the polling interval between two pools, navigate to Configure | License 
Monitor Configuration | Settings. 


Super User | Help | Log Off 





Getting Started | Monitor Troubleshoot 


Polling Interval (min): 
Polling Frequency in minutes for the configured License Servers 
License Servers 
Total poll duration: 00:00:01 


The combined time to successfully poll all License Servers 


poling Eror: [sena enoi V 


Send an email to the Administrator if License Server Monitor polling fails 


| Save Changes | 



































Setting the polling interval to 15 minutes means that a polling cycle will be initiated 
15 minutes from the time that the last polling cycle completed. 


The total poll duration is the sum of the time taken to successfully poll 


all the enabled license servers during the last poll. We can use this 


value to help us set a realistic polling interval. 
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3. For usage information about the published application, make sure that the EdgeSight 
for XenApp Support feature is configured as On - Basic and Advanced Agents by 
navigating to Configure | Server Configuration | Settings | Agent Support. 


















EdgeSight for XenApp Support: | On - Basic and Advanced Agents V 
Types of EdgeSight for XenApp agents, if any, that this server should support. 


EdgeSight for XenDesktop Support: 
Support for EdgeSight for XenDesktop agents. 


EdgeSight for Endpoints Support: 
Support for EdgeSight for Endpoints agents. 
License Server Name: 
License server used for EdgeSight for Endpoints licensing. 
License Server Port: 


License server port used for EdgeSight for Endpoints licensing. The default license server port is 27000. 


Save Changes 





Status 

Settings 

Reporting Services 
EdgeSight Licensing 
Authentication 


Data Maintenance 


Companies 








Unmanaged Devices 




















4. To track the usage of Citrix licenses, applications, and session durations, click on the 
Track Usage tab. 





Overview 


fo Citrix Licensing 
| 
License Usage Trending 


Historical license utilization information (Day, Week, Month, 
Year). 








Current license utilization information. 


Export User/Device License List 
Export list of User/Device licenses currently checked out, 


~ ©. Published Applications 





Summary for a Farm Summary for a User Grou 








Published Applications with the most launches and the most 
users (top 5 and trend). 
Launch Summary for a Farm 


The number of times a Published Application has been 
launched (summary view). 


Users Summary for a Farm 


The number of unique users per Published Application 
(summary view). 





Session Duration 


Ww Session Duration for a Farm 
Session duration summary and detail. 





Published Applications with the most launches and the most 
users for a user group (top 5 and trend). 
Launch Summary for a User Group 


The number of times a Published Application has been 
launched for a user group (summary view). 


Users Summary for a User Group 


The number of unique users per Published Application for a 
user group (summary view). 


Session Duration for a User Group 
Session duration summary and detail for a user group. 








Once the license server has been configured for monitoring, EdgeSight Server directly polls 
the license server for information on license usage. 


License server monitoring does not require an EdgeSight agent on the Citrix License Server. 
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There's more... 





To view the license server poller logfile, navigate to Configure | Server Status | Server Script 
Host. Locate the core lsm license poller script, then click on the drop-down menu, 
and select View Log. 

















Getting Started Monitor Troubleshoot Plan and Manage Track Usage Browse Configure 





Bookmark This Page Refresh Print 





















App Name State Last Change Path 
, — C:\Program Files (x66)\Citrix\System 
[¥] es zqueue Running 4/14/2013 7:56:04 PM Monitoring\Server\EdgeSight\Scripts\rssh 

| nd core_clean_temp Stopped 4/14/2013 7:56:03 PM 

| 
Messages | 

| m_license_poller Running 4/14/2013 7:56:04 PM 
Server Script Host | 
Grooming Log | [yj Stop g actions Running 4/14/2013 7:56:04 PM 

pi ed: 0, not processed: 0 pi 
— ' Clear Log }_recv Running 4/14/2013 7:56:04 PM 
Job Log | Alerts processed: 0, not processed: 0 





| E core_zbatch_run Stopped 4/14/2013 11:15:32 PM 
Finished batch 'jobs', Duration: Om Os 


About 

















If there is any error in the polling, the logfile will display the error code and the reason for the 
failure and an e-mail are also sent to the EdgeSight administrator. If the license server poller is 
not able to connect to the Citrix License Server then an error code of - 96 is written to the logfile. 


You can also disable polling on any particular license server for maintenance or any other 
reason. If you disable polling, the previously collected license information from disabled 
servers will still appear in the License Usage Trending report, but no new license information 
is displayed for the disabled server in the License Usage Summary report until polling is 
enabled back. 


You can also remove a license server configuration from the EdgeSight database by deleting 
it. If you delete a license server configuration, all license usage data associated with that 
license server is deleted from the EdgeSight database. After deletion, no data from the 
license server is displayed in the license usage reports. 


Resolving performance problems (Advanced) 





EdgeSight provides a centralized console to investigate problems related to sessions, 
applications, systems, and networks without requiring us to somehow log in or connect 
to the device having the problem. 





Getting ready 


The important thing here is that the end device you are troubleshooting should have the 
EdgeSight agent installed. 
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How to do it... 


1. To get the real-time performance data of a device, navigate to Troubleshoot | 
Device Troubleshooter. 


Either enter the IP address or the name of the device you are troubleshooting in 
the Search field or browse in the department tree. 


You can also use the slider to change the time frame for the data you want to 


be displayed. 


3. Click on the Go button. 


Pian and Manage 











Browse Configure 





Track Usage 

User Troubleshooter 

Davies kaukir Selected Device: XenApp65-2.packt-pub.net 

Device Trace Route Search: ‘xenapp65-2 Saco ot aac [=] 
Thu 7:51 PM Fri 7:51 PM Sat 7:51 PM Now 

Device Process List XENAPPO5S-2 y 

Find EdgeSight Server Device Details y 
System Summary Process List Session List Stability System Network Summary Network Su b= 
Counter Detail 








4. Click on the System Summary tab and look for important counters here such as 
Committed Bytes In Use, which displays the usage of the system memory. 


Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage 





Troubleshoot | Bookmark This Page Refresh Print 





| Browse | Configure 





User Troubleshooter 











Selected Device: XenApp65-2.packt-pub.net 


Device Troubleshooter 

Device Trace Route Search: xenapp65-2 Device Information Sunday 6:51 PM - Sunday 7:55 PM 
Thu 7:51 PM Fri 7:51 PM Sat 7:51 PM Now Go 

Device Process List XENAPP65-2 \ AA 

Find EdgeSight Server Device Details y 

Real-time Reports = System Summary Process List Session List Stability System Network Summary Network Su > Ii. 


come —_ 
Disk Time EULERIN PNRP E H EIE EOE EAE HERRER “| 
User Time ANN E KITU ST RH 
Privileged Time PASE ARIES NR E EEEE HEEL HEREHERE 
Total Processor Time AARE EE EEN EU ELU EITE 
Peak Total Processor Time ACERIN EEEE E E AR ELE HEEE 
Committed Bytes In Use KUMKATA, 
Pages Input Per Second KIHEHE ANI HAFIFU 
Page Faults AAA NOAN LEO RHINE EHLE 
Current Connections T ON N 











5. Click on the counter you want to have a much deeper look at and EdgeSight will 
display more detailed information in a pop-up window. You can also click on a point 
on the pop-up chart to display point-in-time data for the counter. 
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Committed Bytes In Use 


Select a point for more information 


33.61 % 
Frosi00 PM 


6:52 PM 6:57 PM MDA PM 7:07 PM TiL? PM fil? PM fi22 PM 7:27 PM 9:32 PM 7:37 PM Tige PM 7:47 PM T52 PM 





In cases where the device is a XenApp server running a basic-level agent, data will not be 
displayed in some of the tabs; instead, a message is displayed in each affected tab. 


There's more... 


Similar to Device Troubleshooter, the User Troubleshooter page can be used to display 
detailed performance data for sessions across a farm for any specified user. You will need to 
provide the username, and optionally the name of the server hosting the session, and then 
click on Find Sessions. 


Several steps are involved from the time a user clicks on the icon of a published application 
to launch and use the application till the time the application finally launches. EdgeSight for 
XenApp can be used to diagnose those slow logins or slow sessions problems reported by the 
users; it lets you examine the steps involved and the time required to complete each step. 
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User Troubleshooter 






Device Troubleshooter 








Dai Tace Rontti Enter a User: -pub.net\adminisrato! Device (Optional): All Sessions v Find Sessions 
Dei Procena iit Session ID Server Name Initial Application Client Name/IP Logon Time Logoff Time 


Find EdgeSight Server 
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If no default credentials were specified for the farm before, then you can click on the 


browse button E and provide the credentials in the Find a XenApp Session - Webpage 
Dialog window. 


3 Find a XenApp Session -- Webpage Dialog 


XenApp Session Wizard 


| Select one or more farms that you wish to search fram the list belar, 


Filter: | (© By Farm Mame Filter | | 
show: l 25 E items: [1 to 3 (of 3] 


Credentials 


. Farm Name & 








. XenAppso =Not Set= LE 
F XenAppeo <Not Set» A 


[F XenAppes <Not Set» | 





You can specify unigue credentials for each KenApp farm in your environment. 


You can also use the Device Process List page to display detailed information about 
processes that are currently running on the selected device. 


Getting Started | Monitor | Troubleshoot | Plan and Manage | Track Usage Browse Configure 





Troubleshoot Bookmark This Page Refresh Print 

User Troubleshooter 

Device Troubleshooter Processes — Device: XenApp60-2,packt-pub.net Sal 

Device Trace Route Processes: 69 

Device Process List Image Name PID. User 

Find EdgeSight Server m] Cdfsveexe*32 1756 NT AUTHORITY\NETWWORK SERVICE 


Real-time Reports ed itri 1884 NT AUTHORITA SYSTEM 
© Properties 3680 PACKT-PUB\administrat 
aes - administrator 
Recent Reports ad EJ Generate Snapshot P 
EONO TIEKE 5788 PACKT-PUB\ administrator 
fy] Cpsveexe 1992 NT AUTHORITYLOCAL SERVICE 
fy] CSrs5,exe 728 NT AUTHORITYSYSTEM 
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You can also generate a diagnostic snapshot (Normal or Full), which allows us to remotely 
analyze the current state of the selected device and investigate whether a particular process 
is the cause of the problem you are investigating. The snapshot generates a dump file on the 
selected device and is also uploaded to the server as an alert. 
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One other very useful troubleshooting tool here is the Device Trace Route tool. 




















Super User | Help | Log Off 
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Troubleshoot Bookmark This Page Refresh Print 





User Troubleshooter 


. £ (l. 
Device Troubleshooter Device: |KenApp60-2.packt-pub.net za 

, | Start trace 
Device Trace Route Host: 192.168.1.110 MV Lookup names 


: i Status: Idle 
Device Process List 


Find EdgeSight Server Hop Host Name IP Address Avg RIT Min RTT Max RTT 


Real-time Reports h.d 1 ENTERPRISEA 192.168.1.110 0 0 0 
Trace complete 
Recent Reports ae à 














The Device Trace Route tool can be used to identify and route problems you may have; it allows 
you to execute a trace route from the selected remote device to a specified network host. 





Grooming EdgeSight databases (Advanced) 


Due to the large amount of data collected by EdgeSight, it is recommended that good 
housekeeping should be completed by the EdgeSight administrator for EdgeSight to provide 
optimal results. 


Similar problems can also be noticed if there is not enough disk space on the drive or other 
problems with the database. As a result of any of these problems, grooming errors might 
occur and those will also be displayed in the console. 


In EdgeSight the primary database management mechanism is called grooming and is 
defined as the process of removing older data from a database at regular intervals to make 
room for new data. 





How to do it... 


There are eight data files in the EdgeSight database; the default location of these files is at 
C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\DATA\. 


1. We first need to find the data files that are larger in size than other data files. We can 
run the following query to extract this information: 


SELECT Name, (size*8)/1024 Size 
FROM sys.master files 
WHERE DB NAME(database id) = 'Edgesight' 
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The following table is the output | received after executing the query. Your output 
(size) will be different: 


Edgesight 2,500 

Edgesight log 45,052 
Edgesight FG1 Data 12,820 
Edgesight FG2 Data 25,350 


Edgesight FG3 Data 1,322 
Edgesight FG4 Data 46,623 
Edgesight FG5 Data 8,250 
Edgesight FG6 Data 245,020 
Edgesight FG7 Data 12,500 





From the previous results we can see that in our case the database Edgesight _ 
FG6 Data is the largest in size. The size is in MBs. 


2. The next step is to determine the names of the tables that are hosted by that 
particular file group. We can determine those names by running the following query: 


SELECT DISTINCT object name(sys.sysindexes.id) as 'Table Name' 
,sys.filegroups.name as 'File Group Name' 


FROM sys.sysindexes, sys.filegroups 
WHERE objectproperty (sys.sysindexes.id,'IsUserTable') = 1 
AND sys.filegroups.data space id = sys.sysindexes.groupid 


ORDER BY sys.filegroups.name 


The output from this query in my case was as follows: 


C] Results | 23 Messages | 
coal T able Name | File Group Name 


20 | alert 
24 | alert param 
30 | alert param stage 


drive space 
32 | system per 
l core nel stat 


“sunman unnNNNANANNNNANNANNNNANNANNANANNANNNNANNANNENANNA 


3 core_net_trans 


35 | ctrs atm computer 
36 | ctr atm comput... 
af | ctrso atm item 


38 cts atm item sta... 


} 29 | etre atm hook 
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3. The next step now would be to find out the number of rows in each table. Run the 
following query in SQL Server Management Studio to find the number of rows in both 
the core net trans and core net stat tables: 

SELECT sysobjects.Name, sysindexes.Rows 


FROM sysobjects INNER JOIN sysindexes ON sysobjects.id = 
sysindexes.id 


WHERE sysindexes.IndId < 2 AND sysobjects.Name IN('core net stat', 
‘core net trans') 


The output from this query in my case was as follows: 


core net stat 250475223 





core net trans 2457843 


These results clearly tell us that the table named core net trans has more rows 
than core net stat and hence core net trans would also be much larger in 
size compared to core net stat. 


4. The next step would be to find out the number of records that for some reason could 
not be deleted after the number of Groom Days has passed. The default Groom Days 
value for both the core net trans and core net stat tables is 10 days. To 
verify the Groom Days you can navigate to Configure | Server Configuration | Data 
Maintenance | Grooming. 
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Grooming data is very important to the health and maintenance of your database. By aggressively deleting data that is 
License Monitor Configuration w | unimportant or becomes stale quickly, reports will run faster and your server can support more clients. 



























































Server 9 Report Data < SOL Server Table | SQL Server View gen 
Status : - =i 
Broker History broker_history 30 
Settings z : 3 3 
Company Devices instance vw_es_archive_device_asset_summary 30 
Reporting Services 5 
Device Asset Changes asset_change 90 
EdgeSight Licensing : ; ; A 
Disk Usage drive space vw es archive drive space (30 
Authentication z E ; 
Environmental Usage image_event vw_es_archive_environmental_usage 30 
Data Maintenance ; : i = e : en 
License Server Monitor Ism_license_statistics vw Ism archive license statistics 365 
Upload Configuration z F i 
Light Trace Events Itrace_event vw_es_archive_light_trace_event 30 
Groomi = 
z9 Messages message 30 
Jobs 
Network Performance core_net_stat vw_es_archive_application_network_performance 
Companies . 3 gi A 
Network Transactions core net trans vw es archive application transaction performance 
Unmanaged Devices y EY 
Process Performance image_pert vw_es_archive_application_performance 30 
Server Status ae ; es 
Process Usage usage vw_es_archive_application_usage 90 | 











5. Wecan use the following guery to determine the number of records (if any) that could 
not be deleted: 


SELECT COUNT (*) FROM CORE NET TRANS 
WHERE dtperiod < GETUTCDATE() - 10 


ry 
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If rows are returned from the preceding query that were older than 
> 11 days, then that would mean that grooming failed. If no rows are 


returned older than the 10 days, further investigation needs to be 
performed and you might start from taking a look at what, and how 


much, data is stored inside the particular table. 


6. Now wecan run this query to delete rows by increments of 100,000: 


Declare @row int; cfl declare @date datetime; cfl set @date = 
GETUTCDATE() - 10 


Set @row = (select COUNT(*) from core net trans where dtperiod < @ 
date); 


While @row <> 0 
Begin 
Delete top(100000) from core net trans where dtperiod < @date 


Set @row = (select COUNT(*) from core net trans where dtperiod < @ 
date); 


End; 


7. Wealso need to reclaim the disk space after removing the unwanted rows. To do 
that, open SQL Server Management Studio and right-click on your EdgeSight 
database name. Here | have used EdgeSight as the name; hence, click on 
EdgeSight | Tasks | Shrink | Files. 


File Edt View Tools Window Community Help 
: $ new Query | D | BtSialiaA Gla. 
Obiect Explorer 


Expiore -xE 
Conect- | 32 9 a YIS | 
E |b EdgeSight1 (SOL Server 10.0.5500 - PACKT-PUB\, 

2) LI Databases 

© C System Databases 
E C Database Snapshots 
f Edoe wht 


a R New Database... 
(+) Repor 
New ry 
a (9 Securty - 
a O Server Ob Script Database as > 


Launch Database Mirroring Monitor... 
Ship Transaction Logs... 
Generate Scripts... 
Publish using Web Service... 
Import Data... 
Export Data... 
4 Copy Database... 


Output 
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8. Select FG6 as the Filegroup value and click on OK. 











Selecta pag age ES Script ~ |") Help 
LA General 
The size of the database is reduced by shrinking individual files to release unallocated space. To 
shrink all database files, use Shrink Database. 
Database: [EdgeSight 
Database files and filegroups 
File type: | Data = | 
Filegroup: [PRm ay o 
File name: 
Location: 
Currently allocated sp 
Available free space: 
Shrink action 
n (@ Release unused space 
Baia n C Reorganize pages before releasing unused space 
EdgeSight! Shrink file to: [| 5004 MB (Minimum is 33 MB) 
ert B v adinirüsirator C Empty file by migrating the data to other files in the same filegroup 
32 View connection properties 
Ready 

















There's more... 





You can also limit data uploads from the agents to the EdgeSight Server database by 
deselecting the type of performance data you are not interested in gathering. To configure 
these settings, navigate to Configure | Server Configuration | Data Maintenance | 
Upload Configuration. 
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Company Configuration ; : . 9 
a ee ee z The amount of data uploaded to the server directly impacts the size of your database and the performance of the server, The server will run faster and 
will be able to support more devices if you do not upload data that is not important to you, 
ST i 
Status Iv Device Asset Changes 
Settings Iv Disk Usage vw_es_archive_drive_space 
Reporting Services p” Environmental Usage ww es archive environmental usage 
EdgeSight Licensing IV Light Trace Events vuv e5 archive light trace event 
Authentication Iv Network Performance vuv e5 archive application network performance 
Data Maintenance Iv Network Transactions yuyo 25 archive application transaction peiformance 
Upload Configuration V Process Performance vw_es_archive_application_performance 
Grooming Iv Process Usage vw_es_archive_application_usage 
Jobs IV Session Performance vuv_ctrx_archive_session_pert 
Companies Iv Stability vu es archive alert 
Unmanaged Devices Iv System Performance vw e5 archive system performance 
Iv XenApp Application Response vuu ctre archive application response 











This also optimizes the EdgeSight Server performance. 
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